home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / packet / p_aa4re / bblook3f / bblook.doc < prev    next >
Encoding:
Text File  |  1994-11-02  |  10.6 KB  |  220 lines

  1.  
  2. BBlook.EXE  Version 2.13E (c) 1991-1994 by Freeman M. Crosby W1NPR
  3. For AA4RE REBBS V2.13+
  4. ===============================================================================
  5. RECENT CHANGES:
  6. BBlook no longer uses Msg.bb for any of it's operation.
  7. BBlook's log file to the sysop is now named BBlook.out
  8. A Date field is now appended to the file listing each time a file is updated.
  9. Other BBseries programs will use this information.
  10.  
  11. BBhlgu output file option to update other REBBS stations using BBlook 
  12. / NL option no longer supported.
  13. Optional run-time regulated by the number of headers to be done at once.
  14. See Last.hdr option info below.
  15.  
  16.  
  17. SAM Callsign users:
  18. BBlook now will provide several new fields to your Hlookup.bb file which is
  19. obtained from the SAM CallSign database for USA & Canadian BBS's as follows.
  20.  
  21. BBScall Hier.addr. { City State County Zipcode } Date
  22.  
  23. This information may be used directly by BBreqyp.exe ( Yellow page server ),
  24. BBhledit.exe or you may refer to it with a browse/text editor for your own use.
  25.  
  26. ===============================================================================
  27. Other Hlookup programs exist and no claim is made that this one is of any
  28. advantage over them. Any suggestions will be appreciated.
  29. It was written to be quick & simple & handle large Hlookup's
  30. =============================================================================
  31. First thing ! Make a backup of your hlookup.bb file before proceeding. 
  32.  
  33. Quick start:
  34. If you are in a hurry and don't want to play with options.
  35. Place BBlook.exe in your default "BB" directory and enter ES BBLOOK BBLOOK.EXE
  36. on the command line. BBlook will run quite a while the first time and several
  37. repeats of the same command should be made until you see 0 headers in 0 messages
  38. at the end of the run.
  39. If this is OK then place this line in Wakeup.bb
  40.  
  41. ==/==/== ==:55 ES BBLOOK BBLOOK.EXE
  42.  
  43. Otherwise see below:
  44.  
  45. =============================================================================
  46. If you wish more options:
  47.  
  48. This ZIP contains two .EXE files. You should run BBhfix.exe before running
  49. BBlook.exe  Make sure that BBhfix is in the "BB" directory and that either
  50. a path to your DOS sort program is available or sort.exe is in the "BB" 
  51. directory. BBhfix will complile all the present records in alphabetical
  52. order and remove any duplicate records. You should run BBhfix as a DOS
  53. command outside the REBBS program in most cases.
  54.  
  55. If you wish to run it in Wakeup.bb automatically you may use a suffix.
  56. BBHFIX.EXE /A   will cause it to run silently with no options.
  57.  
  58. Auto mode will read Hlookup.bb & produce Hlookup.bb and save your old one
  59. as Hlookup.old
  60.  
  61. Use Rebbs's CLOSE - S first if needed  BBhfix will take several minutes to
  62. run.
  63.  
  64. NOTE !
  65. BBHFIX.EXE is menu driven and will offer several options and will create
  66. Hlookup.new as the output file, You will still have the original Hlookup.bb
  67. and Hlookup.new will have to be renamed Hlookup.bb and placed in your "BB"
  68. directory to work.
  69.  
  70. If you maintain a TEMP dos directory ( SET TEMP=C:\TEMP ) or similar then
  71. BBhfix will use this to work in if you wish. If this is a RAM-DRIVE it
  72. will speed it up a lot. This option is not available in Auto mode.
  73.  
  74. =============================================================================
  75. BBlook.exe will maintain your Hlookup.bb file from message headers and any
  76. messages that are sent out with lists of headers in them.
  77. ***** NEW *****
  78. Previous version Prior to V2.13C read msg.bb from the top down and would miss
  79. any messages that were not parsed in the first 800 headers. BBlook now starts
  80. at the bottom and will eventually catch them all if it is run often enough
  81. and before a GM is done. See notes on running in DV.
  82. It runs from wakeup.bb as a server command using ES BBLOOK BBLOOK.EXE as the
  83. proper format. A message is created that tells you of it's progress, if any
  84. during each run. If you don't wish the message use EX BBLOOK.EXE instead.
  85. A *** None found *** message from REBBS will be created if you use the 
  86. ES BBLOOK BBLOOK.EXE command, this is normal.
  87. BBlook may be run in a Desqview window with other BBseries servers in a
  88. batch file with BBwait.exe Obtain BBwait.exe and read the Docs on how this
  89. is done. Older versions MAY NOT be run in DV because of File conficts.
  90. DV/ Windows users may wish to use the  /O option explained below.
  91. ==============================================================================
  92. BBlook.exe will find Hlookup.bb and your message files using parms.bb, it will
  93. keep track of the last message read in a file in your default "BB" directory
  94. called Last.hdr. If you wish to reset BBlook.exe to search back through mgs.
  95. use the command BBlook.exe /r #####  ( a space must be placed after the name )
  96. A combination of suffixes as in / SR 2000 will also work .
  97.  
  98. Last.hdr option:
  99. The file Last.hdr will be created by BBlook.exe on it's first run and the top
  100. line will be the last message number looked at (Not the latest on the system)
  101. The second line will be the total number of headers to look at each run.
  102. You may edit this to any number from 1 to 10000.
  103. The header total will default to 1000 if not changed in Last.hdr
  104. Once changed it will remain until changed again.
  105.  
  106. A second limiting factor will be that there will be a maximum number of 800
  107. changes. Each station will only be updated ONCE per run so this figure is
  108. entirely different than the previous 800 limit which was the total number
  109. looked at.
  110.  
  111. Runs may be extended or shortened depending on the operation you wish.
  112. As long as you are in the normal "BB" directory BBlook may be called from any
  113. directory or path you wish such as ES BBLOOK C:\UTILITY\BBLOOK.EXE 
  114. If you wish to run BBlook from the DOS prompt & want to see it's activity you
  115. may use the suffix BBlook.exe /s, or to do both reset & screen BBlook.exe  /sr
  116. Any time you use the /r reset suffix with a number a space must be between
  117. the "R" and the number  
  118.  
  119. An / O suffix added after the Filename.ext will cause BBlook.out ( The log
  120. file ) to be appended to instead of killed on each run. This will allow you to 
  121. IMPORTE it using wakeup.bb occasionally.
  122.  
  123. An / UD suffix will cause BBlook to create a File of headers that will be
  124. appended to Filename.exe BBHLGU.OUT that may be imported and forwarded to
  125. another REBBS who wishes them. Possibly one which may not be in the main
  126. stream of traffic, or one station in a LAN can parse out headers for all the
  127. rest. These may be re-addrssed by Action.bb or distributed as you wish.
  128. If the / UD option is set then the resident BBlook.exe will not update on
  129. it's own BBHLGU messages.
  130. BBlook may normally be used to update from BBHLGU messages created at other
  131. REBBS locations if this option is not used.
  132. ===============================================================================
  133. Any addresses that exist in your hlookup.bb file will be updated in their
  134. original position in the file. Any additions will be added at the bottom of 
  135. the list. You may run BBhfix.exe occasionally to put them in alphabetical
  136. order if you wish. This will not cause any problem with REBBS either way.
  137. =============================================================================
  138. More OPTIONS:
  139. You may keep your BBlook files in a separate directory if wanted by adding
  140. a line in Parms.bb ;bblook_dir = Path\  otherwise the default directory
  141. will be used.    ( Make sure you use the ";" comment marker in the parameter
  142. -----------------------------------------------------------------------------
  143. Update.not
  144.  
  145. To prevent constant updating of BBS stations who use two Callsigns
  146. You may have a text file list of calls in your ;bblook_dir =
  147. or default directory whichever you use. This file should be named 
  148. UPDATE.NOT and have one call per line up to 30 that will never be 
  149. changed by BBlook, BBludf, or BBwpud. The file must however be in 
  150. the directory you have created your server files in and specified
  151. in parms.bb or the default directory if none is specified.
  152.  
  153. ==============================================================================
  154. IF YOU HAVE PROBLEMS:
  155.  
  156. BBlook & BBhfix contain filtering to try to combat
  157. embedded control characters which may exist in your Hlookup.bb file from
  158. previous use of a word processer or editor. 
  159. If repeated attempts to run these programs fails try a new Hlookup.bb file.
  160. You may obtain a large one with optional fields from the W1NPR LL BBS port
  161. REBBS in the BBDPMI mode will edit the full Hlookup.bb file and may be used
  162. to look for bad formats & control characters ( They often show up bright or
  163. a different color)
  164. ==============================================================================
  165. I recommend running BBlook.exe from wakeup.bb with the defaults, hourly, so
  166. that short fast runs will be created after the initial startup.
  167. Runtime amy be increased or shortened by adjusting the second line in Last.hdr
  168. ==============================================================================
  169. Please report bugs & problems, suggestions welcome.
  170.  
  171. Also try BBuser.exe which will let you find data in both the user file 
  172. and in Hlookup.bb 
  173. BBreqyp.exe and BBrtyp.exe Remote and Real-time servers will use the data
  174. provided by this version of BBlook.exe to maintain a Yellow page database.
  175. =============================================================================
  176. Report bugs & comments to:
  177.  
  178. Oct. 1 to June 1 yearly 
  179. W1NPR@W1NPR.#SRQFL.FL.USA.NA
  180. (813)474-2690     Voice line
  181. (813)475-9526,,,44     REBBS forwarding line
  182.  
  183. (813)475-9526,,,66 Download connection
  184. Updates at 300-14,400 baud Zmodem & etc.
  185.  
  186. June 1 to Oct. 1 yearly
  187. W1NPR@W1NPR.#EMA.MA.USA.NA
  188. (508)362-3940     Voice line
  189. (508)362-8958,,,44     REBBS forwarding line
  190.  
  191. (508)362-8958,,,66 Download connection
  192. Updates at 300 - 14,400 baud Zmodem & etc.
  193.  
  194. 73/Free
  195. W1NPR
  196.  
  197. 
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204. I may be contacted for help at W1NPR@W1NPR.#SRQFL.FL.USA.NA ( Winters only )
  205. or W1NPR@W1NPR.#EMA.MA.USA.NA from June 1st. till Oct. 1st.
  206. or by phone (813)474-2690 (FL) and updates and other REBBS utilities may be 
  207. downloaded from my phone port. Contact me on the voice phone for details 
  208. and a password. I will try to use packet messages to let you know what's
  209. new and the modem welcome screen has the latest updates on it.
  210.  
  211. NOTE ! Enter BETA at the BBS prompt to read all the latest update info.
  212.  
  213. From about June 1, till Oct. 1 of each year my dataline will change to MA
  214. (508)362-8958 & the same BBS will be in operation at this location. The 
  215. voice phone during this period will become (508)362-3940 
  216.  
  217.  
  218. Have fun ! 73 Free , W1NPR...
  219. 
  220.